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Introduction 

TBUG is a powerful, machine -language monitor designed to give you direct 
access to the Z-80 CPU, which is the heart of the Radio Shack TRS-80 
Microcomputer. TBUG provides the capability to: 

1 . Create and modify machine -language programs. 

2. Debug machine-language programs through the use of breakpoints and 
register displays. 

3. Examine and modify the contents of RAM memory and Z-80 registers. 

4. Save and load machine-language programs using cassette tape. 

5. Execute machine-language programs created using TBUG (if you have a 
LEVEL II TRS-80, you can also execute programs created with the 
Editor/Assembler program via TBUG). 

This manual will tell you how to use TBUG. There is also considerable summary 
information on the Z-80 CPU Instruction Set. However, this manual does not 
pretend to teach you to write machine language programs. To do that would 
require at least one full length book. Several such books are listed in 
Appendix G. 

How this manual is organized 

TBUG is available for both LEVEL I and LEVEL II machines. Because of 
differences between LEVEL I and LEVEL 1 1 memory allocation and ROM 
routines, there are a few differences in the way TBUG loads and operates in the 
two machines. 

That's why there are two sections titled, Loading and Using TBUG one for each 
type of machine. A few other sections are broken up this way. Read the sections 
that pertain to your TRS-80. 
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Notation Conventions 

Before going on, you should be aware of the following notational conventions, 
used for the sake of clarity and brevity throughout this manual. 



IENTERI 

CAPITALS and punctuation 



INVERSE CAPITALS 



lowercase italics 



Represents the phrase, "Press 
the ENTER key". 

Indicate material which must be 
entered exactly as it appears. 
Example: 

B nnnn 

Only the command B is entered 
verbatim; you supply a value for 
nnnn. 

Represent input you supply, 
upon prompting from the 
Computer. This convention will 
only be used where necessary to 
distinguish between Computer 
prompting and your input. 
Example: 

#TOl EHEIil 7.o 

The Computer supplies the # 
character, 20, and all the blanks; 
you supply the characters shown 
with gray background. 

Represent words, letters or 
values you supply from a set of 
acceptable values for that 
situation. 
Example: 

P aaaa bbbb cccc name 

aaaa,bbbb,cccc are addresses 
you supply, and name is a name 
you supply. 



nnnnH 



ddddd 



The letter H following a num- 
ber indicates the number is in 
hexadecimal form. See the 
decimal/hexadecimal conver- 
sion chart, Appendix F. 
Examples: 

3C00H is the hexadecimal 
number equivalent to decimal 

number 15360 

OAH is the hex number 
equivalent to decimal 1 

Numbers appearing without the 
H suffix are in decimal form, 
unless described otherwise. 



lsb 



msb 



Indicates the least significant 
byte in a register pair or address 
specification. 
Example: 

FX (lsb) refers to the least 
significant byte of the FX 
register 

Indicates the most significant 
byte in a register pair or address 
specification. 
Example: 

IX (msb) refers to the most 
significant byte of the IX 
register 



Before Loading TBUG.. 



The TBUG monitor program uses only the first 16 columns of the screen for 
displaying Computer output and your input. The other 48 columns will be 
unaffected by TBUG (exception: LEVEL II Punch command). 

For the sake of a few of the examples in this manual, you should clear the display 
(CLS statement or CLEAR key) before loading TBUG. 

One final note: TBUG provides a "live keyboard" - you don't have to press 
lENTERl after each command. 



Loading and Using TBUG 

(LEVEL I only) 

If your TRS-80 is equipped with LEVEL I BASIC, simply load the LEVEL I 
TBUG tape as you would a BASIC Program tape, using the CLOAD command. 
Asterisks will blink on and off as the tape loads. When the program is loaded, 
control is transferred to the TBUG monitor, and a number sign # appears in the 
top left of the Display. This sign takes the place of BASIC'S > prompt. 

Note: If there is an error during loading, the message 

WHAT? 
>_ 

will be displayed. 

Rewind the TBUG tape and start over. You may need to try a slightly higher or 

lower volume setting on your recorder. 

To exit TBUG and return to LEVEL I BASIC: The simplest way is to force the 
Computer into its power-up sequence by typing: 

ftW BIiliia 

Remember, you only type in the characters which are highlighted by the gray 
background. 

Or you can manually reset the Computer by pressing the Reset button on the left 
rear of the case. 

(The J command is explained under TBUG Commands.) 

To return to TBUG from LEVEL I BASIC, you must reload the TBUG tape. 



Using TBUG in LEVEL I 



On a LEVEL I TRS-80, TBUG is loaded into memory locations 4000H through 
43FFH. Thus, your machine-language programs may be written using address 
4400H through the end of memory (4FFFH for 4K, 7FFFH for 16K). The Stack 
Pointer is preset to 43FDH, although you may easily change this to another 
address in memory (above 4400H), if desired. 

One of the features of TBUG, which makes it such a powerful and versatile 
monitor, is the Register Save Area. This area is used to preserve the Z-80 
registers while TBUG is in control. This assures that the register contents will not 
be disturbed by TBUG. 

The TBUG commands, which access the Register Save Area, are: Breakpoint, 
Register, Jump, and Go. When TBUG is entered from a user program via the 
Breakpoint command, the Z-80 registers are placed in the Register Save Area. 
The Register command will display the contents of these registers by calling out 
the Register Save Area addresses. Prior to execution of the user program (via 
Jump and Go commands), the Z-80's registers are loaded from the Register Save 
Area. See the command descriptions for further details. 

On the LEVEL I TRS-80, the Register Save Area is located in memory addresses 
43B7H through 43CEH. Table 1 indicates where each of the Z-80's registers is 
stored. Note: you may set the initial values of the CPU registers by using the 
Memory command to modify the addresses in the Register Save Area prior to 
executing a Jump or Go command. 



Register 


Location 


Register 


Location 


Register 


Location 


A' 


43B8H 


A 


43C0H 


IX(MSB) 


43C8H 


F 


43B7H 


F 


43BFH 


IX(LSB) 


43C7H 


B' 


43BAH 


B 


43C2H 


IY(MSB) 


43CAH 


C 


43B9H 


C 


43C1H 


IY(LSB) 


43C9H 


D' 


43BCH 


D 


43C4H 


SP(MSB) 


43CCH 


E' 


43BBH 


E 


43C3H 


SP(LSB) 


43CBH 


H' 


43BEH 


H 


43C6H 


PC(MSB) 


43CEH 


L 


43BDH 


L 


43C5H 


PC(LSB) 


43CDH 



Table 1. Register Save Area for LEVEL I 



Loading and Using TBUG 

(LEVEL II only) 

If your TRS-80 is equipped with LEVEL II BASIC, you load TBUG under the 
SYSTEM command. Insert the tape into the recorder and adjust the volume to a 
LEVEL II setting (around 4-6 on the CTR-41). Now type 



SYSTEMIHfflia 



*■? 



iiaiffl lENTEFO 



The tape will begin to load, as indicated by the flashing asterisks on the Display. 
When the tape has loaded, the SYSTEM prompt will reappear. Type: 

*? J IENTERI 

A number sign # will appear at the top left of the Display. This is the TBUG 
prompt - comparable to the BASIC prompt > . 

Note: If there is an error during the TBUG loading process, a C will appear 
beside the asterisk in the upper right of the Display. In this case, rewind the tape 
and start over. You may need to use a slightly higher or lower volume setting. 

To exit TBUG and return to LEVEL II BASIC: 

The simplest way is to force the Computer into its power-up sequence by typing: 

an gling] 

Remember, you only type the characters highlighted by the gray background. 

The J command is explained under TBUG Commands. 

Or, you can manually reset the Computer by pressing the Reset button on the left 
rear of the keyboard case. 

Note: If your machine language program has altered the contents of locations 
4000H through 42E8H, pressing the Reset button may not have the desired effect 
of resetting the Computer and returning you to BASIC. In such cases, you'll have 
to turn the Computer off and on again. 



To re-enter TBUG from LEVEL II BASIC: 

Assuming you have not altered the address area where TBUG resides, you can 
return to TBUG from BASIC by typing: 



SYSTEMIHfflia 



*? 1WcraiENTERl 

Notice that this address (decimal 17312) is too low to be protected via the 
MEMORY SIZE specification. Therefore, BASIC program execution will 
typically alter the TBUG resident area, and you'll have to reload TBUG if you do 
any BASIC program execution. 



Using TBUG in LEVEL II 



On a LEVEL II TRS-80, TBUG is loaded into memory locations 4380H through 
497FH. Thus, your machine language programs may be written using address 
4980H through the end of memory (4FFFH for 4K machines, 7FFFH for 16K, 
BFFFH for 32K, FFFFH for 48K). The Stack Pointer is preset to 4980H, 
although you may easily change this to another address in memory (above 
4980H), if desired. 

One of the features of TBUG, which makes it such a powerful and versatile 
monitor, is the Register Save Area. This area is used to preserve the Z-80 
registers while TBUG is in control. This assures that the register contents will not 
be disturbed by TBUG. 

The TBUG commands, which access the Register Save Area, are: Breakpoint, 
Register, Jump, and Go. When TBUG is entered from a user program via the 
Breakpoint command, the Z-80 registers are placed in the Register Save Area. 
The Register command will display the contents of these registers by calling out 
the Register Save Area addresses. Prior to execution of the user program (via 
Jump and Go commands), the Z-80's registers are loaded from the Register Save 
Area. See the command descriptions for further details. 

On the LEVEL II TRS-80, the Register Save Area is located in memory 
addresses 4825H through 483CH. Table 2 indicates where each of the Z-80's 
registers is stored. NOTE: You may set the initial values of the CPU registers by 
using the Memory command to modify the addresses in the Register Save Area 
prior to executing a Jump or Go command. 



Register 


Location 


Register 


Location 


Register 


Location 


A' 


4826H 


A 


482EH 


IX(MSB) 


4836H 


F' 


4825H 


F 


482DH 


IX(LSB) 


4835H 


B' 


4828H 


B 


4830H 


IY(MSB) 


4838H 


C 


4827H 


C 


482FH 


IY(LSB) 


4837H 


D' 


482AH 


D 


4832H 


SP(MSB) 


483AH 


E' 


4829H 


E 


483 1H 


SP(LSB) 


4839H 


H' 


482CH 


H 


4834H 


PC(MSB) 


483CH 


L' 


482BH 


L 


4833H 


PC(LSB) 


483BH 



Table 2. Register Save Area for LEVEL II 



TBUG Commands 

In following the sample displays below, remember that keyboard input (what you 
type in) is highlighted with a gray background. Computer prompts and output 
appear without any highlighting. Note that you can only enter a command when 
the TBUG # prompt appears alone as the last line displayed on the screen. 

Memory 

The Memory command lets you examine the contents of any memory location, 
either ROM or RAM. It also lets you modify the contents of any RAM location. 
To initiate this command, type the letter M followed by the address you want to 
change: 

Mnnnn 

where nnnn is a 4-digit hexadecimal address. 

(All numbers input to or output from TBUG are in hexadecimal.) 

For example, suppose you want to examine the contents of memory location 
3C20H. You simply type M3C20 as follows: 

# IMI MMJMMgM 20 

Notice that TBUG displays the contents of 3C20H immediately after you type the 
fourth digit of the address; also that TBUG inserts spaces in the line for easy 
reading. 

Now that you have initiated the Memory command, you can either leave the 
current address unchanged and look at the next higher address in memory, or 
change the contents of the current address and then advance to the next one. 

To change the contents of the displayed location, type the new 2-digit value (hex 
form) after the displayed value. For example, to change the contents of 3C20H 
from 20H to 4CH, type: 

# IMI EHHJ] 20 2S 
3C21 20 

If you tried the above example, you noticed two things: 

1. TBUG automatically displays the next address in memory along with its 
contents; 

2. the letter L appears toward the middle of the top line of the Display. 



To understand why the L appears, you must realize that addresses 3C00 through 
3FFF are memory-mapped to the Display. In other words, whatever values are 
stored in these locations will automatically be displayed on the screen in ASCII 
form. 

Since 4CH is the ASCII code for the letter L, that letter appears in the Display 
location which corresponds to address 3C20H. 

After you type in the new 2-digit value for an address, TBUG modifies the 
address accordingly and displays the next address. To leave an address 
unchanged, simply press lENTERl and TBUG will move on to the next higher 
address. 

For example: 

# M ESHi] 20 SB 
3C21 26 

3C22 20 
3C23 20 52 
# 

To exit from the Memory command at any time, type an X. This character will 
not be displayed, because it has a control function, causing TBUG to return with 
the prompt. You can then enter any TBUG command. 

Jump 

The Jump command lets you start execution of a machine-language program at a 
specified address. Its form is: 

Jnnnn 

where nnnn is a 4-digit hexadecimal address where execution is to begin. 

When you type in the Jump command, TBUG does the following: 

1 . Loads nnnn into the Program Counter (PC) register; 

2. Loads the other Z80 registers from the Register Save Area; 

3. Begins execution. 

For example, to execute a program beginning at 4A00H, type: 

# H EESffl 

You should take care that the address specified contains an executable 
instruction. That is, it should be a one-byte instruction or the first byte of a 
multiple-byte instruction. 



10 



You may cancel the Jump command any time prior to entering the fourth 
character of the address, by typing the letter X. This will return control to TBUG, 
and you can enter another command. 

Breakpoint 

This command lets you break the normal flow of a program at a pre-specified 
"point" or instruction. It is a very powerful tool and may be used to debug or 
simply terminate a program. 

To initiate the Breakpoint command, type B followed by the hex address where 
you wish the break in execution to occur: 

Bnnnn 

where nnnn is the specified break address. This address should contain a 
single-byte instruction or the first byte of a multiple-byte instruction. 

The effect of Bnnnn is to replace the contents of nnnn through nnnn+2 with a 
breakpoint sequence. The previous contents of these locations are saved and can 
be restored later with the Fix command (see below). 

Note: You can cancel the Breakpoint command prior to typing the fourth digit of 
the address, by typing an X. 

When program execution reaches the breakpoint you have entered, control will 
be transferred to TBUG. The Z-80's register contents will be placed in the 
Register Save Area, where you may examine or modify them (see Register 
command). 

Don't try to place more than one breakpoint in a program at once, since only the 
last entered breakpoint can be restored to its former contents via the Fix 
command. 



Example: 



# mi garni c3 

5201 A0 IENTERI 

520 2 52 J2 

# ia gang 

# JBi aaaii cd 



ii 



In this example, addresses 5200H through 5202H contain a Z-80 instruction 
(JUMP to 52AOH). A breakpoint is inserted at 5200H. If you examine 5200H, 
you see that it now contains CDH, which is the first byte of the breakpoint 
sequence. 

When you attempt to execute beginning at 5200H, the breakpoint is encountered 
immediately, so that TBUG regains control and returns with the # prompt. To 
demonstrate this, type: 

At this point, you can examine registers and memory, and type in any TBUG 
command. However, if you plan to restore the breakpoint's previous contents 
with Fix, you should do it now, or before the user PC contents are modified. 

* 1 

# iM naana c3 ienteri 

5201 A0 IENTERI 

5202 52 

Notice that 5200H through 5202H have been restored with their previous 
contents. You can now continue execution with a Go or Jump command. 

Fix 

Fix is used in conjunction with the Breakpoint command. After a breakpoint has 
been reached during execution of a machine language program, and control 
returns to TBUG, type F. This tells TBUG to retrieve the previous contents of the 
breakpoint, and place it in the address specified by the user PC. See Breakpoint 
for examples. 

Use the F command after executing a breakpoint and before changing the user 
PC contents. If you use it any other time, it may destroy part of your 
program. 
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Go 

The Go command tells TBUG to begin execution at the address specified by the 
user PC. You should only use it when you know what's in the user PC register, or 
immediately upon returning from and Fixing a breakpoint. Otherwise, Go may 
send the Computer on a "voyage into nowhere". 

To use the Go command, simply type the letter G. TBUG will immediately load 
the Z-80 registers from the Register Save Area and begin execution. 



Register 



The register command lets you examine the contents of the Register Save Area. 
Simply type the letter R, and TBUG will display the Register Save Area as 
follows: 



AT' 
D'E' 


B'C 
H'L' 


AF 
DE 


BC 
HL 


FX(msb,lsb) 
SP(msb,lsb) 


lY(msb,lsb) 
PC(msb,lsb) 



To modify the contents of any register, place the desired value in the appropriate 
Register Save Area address. The next time you execute a Jump or Go command, 
the Z-80 registers will be loaded from the Save Area, and any changes you've 
made will be implemented then. 

Punch 

The Punch command lets you dump the contents of memory onto tape. This is 
the only command which must be specified differently for LEVEL 1 and 
LEVEL 11 machines. Program tapes created with Punch can be loaded just as 
TBUG is loaded. 

Note: The cassette recorder should be in the Record mode prior to executing the 
Punch command. 
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Punch 
LEVEL I only 

In LEVEL I TBUG, the Punch command has the following form: 

P aaaa bbbb 

where aaaa is the hexadecimal starting address of the memory block 
you are dumping to tape; 
bbbb is the ending address of the memory block. 

For example, suppose your program resides from 5000H through 521 FH. You 
may save this program on tape by typing the following (be sure the recorder is in 
the Record mode): 

# la Hililillggia 

The TBUG monitor will turn on the recorder, write the contents of the specified 
memory block onto tape, turn off the recorder and display the prompt character 
on the next Display line. 

The data from memory is put onto tape in the following format: 

4. A 128-byte leader consisting of zeroes. 

5. The synchronization code (A5H). 

6. The starting address for the data (lsb, msb). 

7. The ending address for the data plus 1 to include checksum (lsb, msb). 
The data. 

A one-byte checksum, which is the sum of all the data bytes, in two's 
complement form. 

You may cancel the Punch command prior to typing the last character of the 
ending address, by typing the letter X. 

Punch 
LEVEL II only 

In LEVEL II TBUG, the Punch command has the following form: 

P aaaa bbbb cccc name 

where aaaa is the hex starting address of the block to be dumped; 
bbbb is the ending address of the block; 
cccc is the entry point - this is where execution is to begin 

after the tape is loaded; 
name is the file name for the program you are saving on tape. 
(More below.) 
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Tapes created by the LEVEL II TBUG Punch command can be loaded under the 
SYSTEM command -just as TBUG itself is loaded. All SYSTEM tapes have a 
file name, and that's why the Punch command requires that you specify one. 

This file name can be any sequence of characters - from one to six total 
characters. If you wish to use a name shorter than six characters, you must press 
the lENTERl key to start the Punch process. If you enter a six-character file 
name, the Punch process starts automatically. Use a file name that's easy to 
remember and type in. 

For example, suppose your program resides from 5000H to 521FH, and you want 
to save the program on tape under the name TEST. Then type: 



# 



P 5000 521 F 5000 TESTiaMiaa 



if you wanted to save the same program under the name TESTOI, you'd type: 

#l 



P 5000 521 F 5000 TEST01 



In the first case, the Punch command begins immediately after the lENTERl key 
is pressed. In the second case, as soon as you type the sixth character of the file 
name, the Punch process begins. Be sure the recorder is in the Record mode 
before you type in this command. 

You can cancel the Punch command while you are entering the start, end or entry 
address, by typing the letter X. If, however, you are typing in the file name, you 
must hit the BREAK key, since X is a valid character for a file name. 
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To execute Punch, TBUG turns on the recorder, writes the specified memory 
contents onto tape, turns off the recorder and returns with the prompt character. 
The format of the output tape is: 

1. A 255-byte leader consisting of zeroes. 

2. The synchronization code (A5H). 

3. The file name header code (55H). 

4. The six-byte file name padded with trailing blanks (20H). 

5. One or more data blocks as followed: 

a. The data header code (3CH). 

b. The number of bytes in this block (from 1 to 256, where 256 is 
represented by 00H). 

c. The start address for this block (lsb, msb). 

d. The data (1 to 256 bytes as specified in 5b. 

e. A one-byte checksum, which is the sum of the start address and the 
data. 

6. The entry point header code (78H). 

7. The entry point address (lsb, msb). 

There is no limit as to how many data blocks (item 5 above) are written; TBUG 
will figure how many are required based on the starting and ending addresses you 

supply. 

Loading stops when the entry point address is read. 

Note: that this tape format may only be read by the TBUG Load command 
(described below) or the LEVEL 11 BASIC SYSTEM command. 

Load 

The Load command is used to transfer the contents of a previously recorded 
machine-language tape into the TRS-80's memory. This command is specified by 
typing the letter L. TBUG will execute the command immediately. 

During execution, TBUG will not accept any keyboard input. Therefore the only 
way to cancel the Load command is to press the reset button on the left rear of 
the TRS-80 keyboard case. 

During loading, an asterisk will appear on the Display and blink as data is input 
to the Computer. This asterisk will be in the upper left of the Display for 
LEVEL I and in the lower left for LEVEL II. The prompt character will appear 
on the next Display line following completion of the load function. 

If a checksum error occurs during loading, TBUG will display the letter E on the 
Display line next to the Load command. In this case, try to load the tape again, 
perhaps using a slightly higher or lower volume setting. 
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Conversion Considerations 

If you currently own a LEVEL I TRS-80 but plan to eventually upgrade to a 
LEVEL II, you will probably want to convert several of your TBUG created 
programs to LEVEL II as well. You should be aware that there are several 
important differences between LEVEL I and LEVEL II which will require you to 
modify your LEVEL I machine-language programs so that they will run on 
LEVEL II. This section will provide you with information and hints, to make the 
conversion much simpler. 

There are three subjects which require attention when converting from LEVEL I 
to LEVEL II: 

1 . Program location. 

2. CALL statements to ROM subroutines. 

3. Cassette tape format and transfer rate. 

The first item refers to the fact that LEVEL I TBUG is located from address 
4000H through 43FFh, while LEVEL II is located from 4380H through 497FH. 
Therefore, if you have a LEVEL I machine-language program which begins 
below 4980H, you will have to "relocate" it under LEVEL II. This is somewhat 
cumbersome since all CALL and JP statements (along with some others) will 
have to be changed. The easiest way to avoid this problem is to create your 
LEVEL I programs above 4980H to begin with. 

The second item refers to the problem of changing CALL statements that utilize 
ROM subroutines. In the Appendix of this manual, you will find instructions on 
how to use certain ROM subroutines. You will also note that the LEVEL I CALL 
routines are somewhat different from the LEVEL II CALLS. As an example, let's 
say you want to use the keyboard input routine in ROM to input a byte from the 
keyboard. In LEVEL I, you would code the following: 



4800 CD400B 00110 AGN 
4803 28FB 00120 



CALL 064 OH 
JR Z , AGN 



SCAN KEYBOARD 

GO AGAIN IF KB CLEAR 



However, in LEVEL II, the same coding would look like this: 



4A00 


D5 


00110 


PUSH 


DE 


• MIUIST SAVE DE 


4A01 


FDE5 


00120 


PUSH 


IY 


• AND IY 


4A03 


CD2B00 


00130 AGN 


CALL 


2BH 


•SCAN ROUTINE 


4A06 


B7 


00140 


OR 


A 


• A=0 I F KB CLEAR 


4A07 


28F7 


00150 


JR 


Z,AGN 


•BRANCH IF NO BYTE 


4A09 


FDE1 


00160 


POP 


IY 


•RESTORE IY 


4A0B 


Dl 


00170 


POP 


DE 


•AND DE 
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As you can see, there is a substantial difference in the number of instructions and 
the instructions themselves. 

The easiest way to convert this type of program from LEVEL 1 to LEVEL II is to 
prepare your LEVEL I program with the conversion in mind. That is, while you 
are creating your LEVEL I TBUG programs and you desire to use a LEVEL I 
ROM CALL to perform some function, look at both the LEVEL I and LEVEL II 
subroutine calls to see how they differ. If LEVEL II requires more bytes than 
LEVEL I, you should "pad" your LEVEL I routine with NOP (00H) instructions 
until it is the same size. In the above example, addresses 4A03H through 4A0AH 
of your LEVEL I routine would contain NOP instructions - the next actual 
instruction in the routine would be at location 4A0BH. Alternatively, if you want 
to reduce the conversion work even more, you could code your LEVEL I routine 
as follows: 



4A00 


D5 


00110 




PUSH 


DE 


•REQ'D FOR LEVEL II 


4A01 


FDE5 


00120 




PUSH 


IY 


TO SAVE DE & IY 


4A03 


CD4008 


00130 


AGN 


CALL 


0B40H 


•CHANGE CALL FOR LEVEL II 


4A06 


00 


00140 




NOP 




•USE 'OR A' FOR LEVEL II 


4A07 


28F7 


00150 




JR 


Z,AGN 


•DO AGAIN IF KB CLEAR 


4A09 


FDE1 


00160 




POP 


IY 


•RESTORE IY 


4A0B 


Dl 


00170 




POP 


DE 


• AND DE 



Note that only source lines 130 and 140 need be changed to adapt the routine to 
LEVEL II. Of course, the LEVEL I routine automatically displays the byte; the 
LEVEL II does not. If needed, the display byte routine will have to be added. 

The last conversion item comes from the fact that you cannot load LEVEL I 
tapes on a LEVEL II machine. The obvious solution to this problem is to re-enter 
your machine -level programs using the Memory command under LEVEL II. This 
assumes that you have accurate hard-copy versions of these programs from 
which to copy. 

Fortunately, the obvious solution has an alternative - you can create a 
machine-language program under LEVEL II which can allow you to read a 
LEVEL I tape! The routine which performs this function is shown in Listing 1. 
You may enter this program using TBUG or the TRS-80 
EDITOR/ASSEMBLER. Load the program into memory along with TBUG. 
Using the Jump command, type 

# W EHilB 
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Load your LEVEL I TBUG-created tape into the cassette, press the Play button, 
and hit . The familiar asterisks will appear at the upper left on the Video display 
as the program is loaded from tape. Upon completion, control will return to 
TBUG. You may now make any modifications to your LEVEL I program you 
desire; then, using TBUG, output it to a tape in LEVEL II format. NOTE: you 
will find a "relocation" function built into this program. The instruction at 
location 4 130H: 

4130 010000 04320 LD BC,0 

may be used to change the load address of your program. For example, suppose 
your LEVEL 1 program was originally located at memory locations 4400H 
through 4623H. If you try to load this program from tape, it will destroy part of 
TBUG. You may, however, change the load address to elsewhere in memory by 
putting in a displacement value in locations 413 1H and 4132H. Your program 
may be loaded into 5000H through 5223H, for example, by changing the 
instruction at 4130H to: 

4130 01000C 04320 LD BC,0C00H0 

Because of the way the program is written, the value 0C00H would be added to 
4400H and 4623H before the data is loaded. 

This will allow you to read your LEVEL 1 tapes on your LEVEL II machine, and 
perform program relocation if necessary. However, you will still have to make 
the other conversions described above. 

Note: Be sure you remember to turn the volume up to between 7-9 on the 
recorder when you load the LEVEL I program for conversion. 

If an error occurs during loading of the LEVEL I tape, the leftmost asterisk will 
be replaced by an E, and TBUG will regain control. Reload the LEVEL I tape 
(try a different volume setting). 
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4380 
3C00 
002B 

4100 
4100 
4103 
4106 
4107 
4109 
410B 
410D 
4110 
4111 
4114 
4116 
4118 
411A 
411D 
4120 
4123 
4124 
4127 
4128 
412B 
412C 
412F 
4130 
4133 
4134 
4135 
4136 
4137 
4139 



310041 

CD2B00 

A7 

28FA 

FEOD 

20F6 

CD8F41 

AF 

CD6741 

FEA5 

20F9 

3E2A 

32003C 

32013C 

CD8741 

57 

CD8741 

5F 

CD8741 

67 

CD8741 

6F 

010000 

09 

EB 

09 

EB 

OEOO 
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04000 
04005 
04010 
04020 
04025 
04027 
04028 
04029 
04030 
04040 
04050 
04055 
04065 
04070 
04080 
04090 
04093 
04095 
04100 
04110 
04120 
04130 
04140 
04150 
04160 
04170 
04180 
04190 
04200 
04210 
04220 
04230 
04240 
04250 
04260 
04270 
04280 
04290 
04300 
04310 
04320 
04330 
04340 
04350 
04360 
04370 
04371 



LEVEL I CASSETTE LOAD 

THIS PROGRAM LOADS A LEVEL I OBJECT FILE TAPE 
INTO A LEVEL II TRS-80 

VOLUME ON THE RECORDER MUST BE 
AT A LEVEL I SETTING (7-9) 

ADDRESSES 4131H (LSB) AND 4132H (MSB) MAY BE 
CHANGED TO RELOCATE INPUT PROGRAM 

ROM AND TBUG ADDRESSES 



TBUG EQU 

VIDEO EQU 

KEY EQU 
7 

ORG 
START LD 
CHKEY CALL 
AND 
JR 
CP 
JR 

CALL 
XOR 
CLOAD1 CALL 
CP 
JR 
LD 
LD 
LD 

CALL 
LD 

CALL 
LD 

CALL 
LD 

CALL 
LD 
LD 
ADD 
EX 
ADD 
EX 
LD 
INC 



4380H 
3C00H 
2BH 

4100H 

SP,$ 

KEY 

A 

Z , CHKEY 

0DH 

NZ , CHKEY 

CTON 

A 

GETBIT 

0A5H 

NZ,CLOADl 

A, '*' 
(VIDEO) ,A 
(VIDEO+1) ,A 

GTBYTE 

D,A 

GTBYTE 

E,A 

GTBYTE 

H,A 

GTBYTE 

L,A 

BC,0 

HL,BC 

DE,HL 

HL,BC 

DE,HL 

CO 

HL 



; RETURN TO TBUG ADDRESS 
; UPPER LEFT CORNER VIDEO 
; KEYBOARD SCAN ROUTINE 



SET STACK POINTER 
SEE IF THERE IS 

ANYTHING FROM KEYBOARD 
NO - CHKEY 

YES - CARRIAGE RETURN? 
NO - CHKEY 
YES - TURN ON CASSETTE 

HAVE WE FOUND 

THE SYNC CHARACTER? 
NO - CLOAD1 
TURN ON 
BOTH ASTERISKS 

GET 
START 
ADDRESS 
FOR DE 
GET 
ENDING 
ADDRESS 
FOR HL 
CHANGE CONSTANT 
TO RELOCATE *** 
RELOCATION 
AMOUNT 
TO DE & HL 
ZERO OUT CHECKSUM 
INCLUDE CHECKSUM 



Listing 1. LEVEL I Loader for LEVEL II 
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04380 














04390 


; NOW WE WILL LORD EACH BYTE OFF THE TAPE FIND 






04400 


; STORE IN MEMORY AS INDICATED BY DE AND HL 






04410 










413A 


CD8741 


04420 


CLOAD2 


CALL 


GTBYTE 


•GET BYTE FROM TAPE 


413D 


12 


04430 




LD 


(DE) ,A 


•STORE IT IN MEM 


413E 


13 


04440 




INC 


DE 


• AND STEP COUNTER 


413F 


FEOD 


04450 




CP 


ODH 


•IS IT A CARRIAGE RETURN? 


4141 


200A 


04460 




JR 


NZ , CLOAD3 


•NO - CLOAD3 


4143 


F5 


04470 




PUSH 


AF 


•YES - CONTINUE 


4144 


3A013C 


04480 




LD 


A, (VIDEO+1) 




4147 


EEOA 


04490 




XOR 


OAH 


•BLINK ASTERISK 


4149 


32013C 


04500 




LD 


(VIDEO+1) ,A 




414C 


Fl 


04510 




POP 


AF 




414D 


81 


04520 


CLOAD3 


ADD 


A,C 


•ADD BYTE TO CHECKSUM 


414E 


4F 


04530 




LD 


C,A 


• AND SAVE IT 


414F 


7C 


04540 




LD 


A,H 


•SEE 


4150 


BA 


04550 




CP 


D 


• IF 


4151 


20E7 


04560 




JR 


NZ , CLOAD2 


• WE 


4153 


7C 


04570 




LD 


A,L 


: ARE 


4154 


BA 


04580 




CP 


E 


; DONE 


4155 


20E3 


04590 




JR 


NZ , CLOAD2 


• NO - CLOAD2 


4157 


CD9441 


04600 




CALL 


CTOFF 


•YES - TURN OFF CASSETTE 


415A 


79 


04610 




LD 


A,C 


•IF CHECKSUM 


415B 


A7 


04620 




AND 


A 


• EQUALS ZERO 


415C 


CA8043 


04630 




JP 


Z , TBUG 


RETURN TO TBUG 


415F 


3E45 


04640 




LD 


A, 'E' 


•NO - TURN FIRST ASTERISK 


4161 


32003C 


04650 




LD 


(VIDEO) ,A 


• INTO AN "E" 


4164 


038043 


04660 
04670 




JP 


TBUG 


• AND GO TO TBUG 






04600 


; THIS 


SUBROUTINE READS A 


SINGLE BYTE FROM THE TAPI 






04690 


; PORT 


AND ' 


ADDS' INTO THE 


A REGISTER 






04700 










4167 


D9 


04710 


GETBIT 


EXX 




•USE ALTERNATE REGISTERS 


4168 


08 


04720 




EX 


AF,AF' 




4169 


DBFF 


04730 


GB1 


IN 


A, (255) 


•INPUT SYNC BIT 


416B 


17 


04740 




RLA 




•DO WE HAVE ONE? 


416C 


30FB 


04750 




JR 


NC,GB1 


•NO - GB1 


416E 


067C 


04760 




LD 


B,7CH 


• DELAY 


4170 


10FE 


04770 




DJNZ 


$ 


• LOOP 


4172 


CD9941 


04780 




CALL 


GTS TAT 


•CLEAR INPUT LATCH 


4175 


06F8 


04790 




LD 


B,0F8H 


• DELAY 


4177 


10FE 


04800 




DJNZ 


$ 


• LOOP 


4179 


DBFF 


04810 




IN 


A, (255) 


•GET DATA BIT 


417B 


47 


04820 




LD 


B,A 




417C 


08 


04830 




EX 


AF,AF' 


•DATA BIT IS IN BIT 7 


417D 


CB10 


04840 




RL 


B 


• OF B REGISTER 


417F 


17 


04850 




RLR 




•ADD IT INTO R REGISTER 



Listing 1, cont. 
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4180 


F5 


04860 




PUSH AF 




4181 


CD9941 


64870 




CALL GTSTAT 


; CLEAR INPUT LATCH 


4184 


Fl 


04880 




POP AF 




4185 


D9 


04896 




EXX 


/REGISTERS NORMAL AGAIN 


4186 


C9 


04988 
04910 




RET 


; FINISHED 






04920 


; THIS 


SUBROUTINE CALLS 


GETBIT 8 TIMES 






04930 


; TO GET A FULL BYTE 








04940 








4187 


0608 


04950 


GTBYTE 


LD B,8 


;SET COUNT 


4189 


CD6741 


04960 


GB2 


CALL GETBIT 


;GET R BIT 


418C 


10FB 


04970 




DJNZ GB2 


;LOOP 'TIL WE HAVE A BYTE 


418E 


C9 


04980 
04996 


7 


RET 








05000 


; THIS 


SUBROUTINE TURNS 


ON THE CASSETTE 






05010 


7 






418F 


2104FF 


05020 


CTON 


LD HL,0FF04H 


;SET BIT 2 


4192 


1808 


05030 
05040 


7 


JR CSTAT 








05050 


; THIS 


SUBROUTINE TURNS 


OFF THE CASSETTE 






05060 


7 






4194 


2100FB 


05070 


CTOFF 


LD HL,0FB00H 


; CLEAR BIT 2 


4197 


1803 


05080 
05090 


7 


JR CSTAT 








05100 


; THIS 


SUBROUTINE CHECKS THE PORT STATUS 






05110 


7 






4199 


2100FF 


05120 


GTS TAT 


LD HL,0FF00H 


; CLEAR READ LATCH 


419C 


3AA741 


05130 


CSTAT 


LD A, (STATUS) 




419F 


A4 


05140 




AND H 


;SET AND 


41A0 


B5 


05150 




OR L 


; CLEAR BITS 


41A1 


D3FF 


05160 




OUT (255) ,A 


; OUTPUT TO PORT 


41A3 


32A741 


05170 




LD (STATUS), A 




41A6 


C9 


05180 




RET 




41A7 


00 


05190 


STATUS 


DEFB 




4100 




05200 




END START 





Listing 1, cont. 
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Appendix A. Z-80 Instruction Set 
by Mnemonics 



OPCODE 


SOURCE CODE 


8E 


ADC 


A, (HL) 


DD8E05 


ADC 


A, (IX+IND) 


FD8E05 


ADC 


A, (IY+IND) 


8F 


ADC 


A, A 


88 


ADC 


A,B 



89 
8A 
8B 
8C 
8D 



CE2 


ADC 


A,N 


ED4A 


ADC 


HL,BC 


ED5A 


ADC 


HL,DE 


ED6A 


ADC 


HL,HL 


ED7A 


ADC 


HL,SP 



86 

DD8605 
FD8605 
87 

80 





ADD 


A,C 


82 


ADD 


A,D 


83 


ADD 


A,E 


84 


ADD 


A,H 


85 


ADD 


A,L 



C620 

09 

19 

29 

39 

DDC 

DD] 

DD2 

DD3 

FDC 

FD19 

FD2 9 

FD3 9 

A6 

DDA6 05 



A3 

A4 

A5 

E620 

CB46 

DDCBC 

FDCBC 

CB4 7 

CB4 

CB41 

CB42 

CB43 

CB44 



ADC 
ADC 
ADC 
ADC 
ADC 
ADC 
ADC 
ADC 
ADC 
ADC 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
AND 
AND 
AND 
AND 
AND 
AND 
AND 
AND 
AND 
AND 
AND 
BIT 
BIT 
BIT 
BIT 
BIT 
BIT 
BIT 
BIT 
BIT 



DD0 9 


ADD 


IX, BC 


DD19 


ADD 


IX, DE 


DD2 9 


ADD 


IX, IX 


DD3 9 


ADD 


IX, SP 


FD09 


ADD 


IY,BC 



A,C 

A,D 

A,E 

A,H 

A,L 

A,N 

HL,E 

HL,E 

HL,t 

HL,£ 

A, (HL) 

A, (IX+IND) 

A, (IY+IND) 

A, A 

A,B 

A,C 

A,D 

A,E 

A,H 

A,L 

A,N 

HL,BC 

HL,DE 

HL,HL 

HL,SP 

IX, BC 

IX, DE 

IX, IX 

IX, SP 

IY,BC 

IY,DE 

IY, IY 

IY,SP 

(HL) 

(IX+IND) 



FDA6 05 


AND 


(IY+IND) 


A7 


AND 


A 


A0 


AND 


B 


Al 


AND 


C 


A2 


AND 


D 



CB4 6 


BIT 





(HL) 


DDCB0546 


BIT 


o 


(IX+IND) 


FDCB0546 


BIT 


o 


(IY+IND) 


CB4 7 


BIT 


o 


A 


CB40 


BIT 





B 


CB41 


BIT 


o 


C 



E 

H 

L 

N 

0, 

0, 

o, 
o, 
o, 

o, 

0,D 
0,E 
0,H 



OPCODE 


SOURCE 


CODE 


CB45 


BIT 





L 


CB4E 


BIT 


1 


(HL) 


DDCB054E 


BIT 


1 


(IX+IND) 


FDCB054E 


BIT 


1 


(IY+IND) 


CB4F 


BIT 


1 


A 


CB48 


BIT 


1 


B 


CB4 9 


BIT 


1 


C 


CB4A 


BIT 


1 


D 


CB4B 


BIT 


1 


E 


CB4C 


BIT 


1 


H 


CB4D 


BIT 


1 


L 


CB56 


BIT 


2 


(HL) 


DDCB0556 


BIT 


2 


(IX+IND) 


FDCB0556 


BIT 


2 


(IY+IND) 


CB57 


BIT 


2 


A 


CB50 


BIT 


2 


B 


CB51 


BIT 


2 


C 


CB52 


BIT 


2 


D 


CB53 


BIT 


2 


E 


CB54 


BIT 


2 


H 


CB55 


BIT 


2 


L 


CB5E 


BIT 


3 


(HL) 


DDCB055E 


BIT 


3 


(IX+IND) 


FDCB055E 


BIT 


3 


(IY+IND) 


CB5F 


BIT 


3 


A 


CB58 


BIT 


3 


B 


CB5 9 


BIT 


3 


C 


CB5A 


BIT 


3 


D 


CB5B 


BIT 


3 


E 


CB5C 


BIT 


3 


H 


CB5D 


BIT 


3 


L 


CB66 


BIT 


4 


(HL) 


DDCB0566 


BIT 


4 


(IX+IND) 


FDCB0566 


BIT 


4 


(IY+IND) 


CB67 


BIT 


4 


A 


CB61 


BIT 


4 


C 


CB62 


BIT 


4 


D 


CB63 


BIT 


4 


E 


CB6 


BIT 


4 


H 


CB64 


BIT 


4 


H 


CB65 


BIT 


4 


L 


CB6E 


BIT 


5 


(HL) 


DDCB056E 


BIT 


5 


(IX+IND) 


FDCB056E 


BIT 


5 


(IY+IND) 


CB6F 


BIT 


5 


A 


CB68 


BIT 


5 


B 


CB6 9 


BIT 


5 


C 


CB6A 


BIT 


5 


D 


CB6B 


BIT 


5 


E 


CB6C 


BIT 


5 


H 


CB6D 


BIT 


5 


L 


CB76 


BIT 


6 


(HL) 


DDCB0576 


BIT 


6 


(IX+IND) 


FDCB0576 


BIT 


6 


(IY+IND) 


CB77 


BIT 


6 


A 


CB70 


BIT 


6 


B 


CB71 


BIT 


6 


C 


CB72 


BIT 


6 


D 



OPCODE 


SOURCE CODE 


CB73 


BIT 


6,E 


CB74 


BIT 


6,H 


CB75 


BIT 


6,L 


CB7E 


BIT 


7, (HL) 


DDCB057E 


BIT 


7, (IX+IND) 



CB7A 


BIT 


7,D 


CB7B 


BIT 


7,E 


CB7C 


BIT 


7,H 


CB7D 


BIT 


7,L 


DC8405 


CALL 


C,NN 


FC8405 


CALL 


M,NN 



FDCB057E 

CB7F 

CB7 8 

CB79 

CB7A 

CB7B 

CB7C 

CB7D 

DC84 

FC84 

D48405 

CD8405 

C48405 

F48405 

EC8405 

E48405 

CC8405 

3F 

BE 

DDBE05 

FDBE05 

BB 

B8 

BC 

FE20 

BF 

B9 

BA 

EDA9 

EDB9 

EDA1 

EDB1 

2F 

BD 

27 

35 

DD 

FD 

3D 

05 

0B 

0D 

15 

IB 

ID 

25 

2B 

DD 

FD 

2D 

3B 

F3 

102E 



BIT 

BIT 
BIT 
BIT 



7, 

7, A 
7,B 
7,C 



(IY+IND) 



CALL 

CALL 

CALL 

CALL 

CALL 

CALL 

CALL 

CCF 

CP 

CP 

CP 

CP 

CP 

CP 

CP 



NC,NN 

NN 

NZ,NN 

P,NN 

PE,NN 

PO,NN 

Z,NN 



(HL 

(IX+IND 

(IY+IND 

E 

H 

H 

N 



I 



BF 




B9 


CPC 


BA 


CPD 


EDA9 


CPD 


EDB9 


CPDR 



35 


DEC 


(HL) 


DD3505 


DEC 


(IX+IND) 


FD3505 


DEC 


(IY+IND) 


3D 


DEC 


A 


05 


DEC 


B 



CPI 

CPIR 

CPL 

CPL 

DAA 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DI 

DJNZ DIS 



25 


DEC 


H 


2B 


DEC 


HL 


DD2B 


DEC 


IX 


FD2B 


DEC 


IY 


2D 


DEC 


L 



BC 

C 

D 

DE 

E 

H 

HI 

I> 

I'i 

L 

SP 
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OPCODE 



SOURCE CODE 



ED5E 


IM 


2 


ED7 8 


IN 


A, (C) 


DB2 


IN 


A,N 


ED45 


IN 


C, (C) 


ED5 


IN 


D, (C) 



34 


INC 


(HL) 


DD3405 


INC 


(IX+IND) 


FD3405 


INC 


(IY+IND) 


3C 


INC 


A 


04 


INC 


B 


03 


INC 


BC 



EB 

DDE3 

FDE3 

08 

EB 

E3 

D9 

76 

ED4 6 

ED5 6 

ED5E 

ED78 

DB2 

ED45 

ED5 

ED5 8 

ED4 

ED6 

ED65 

34 

DD 

FD 

3C 

04 

03 

0C 

14 

13 

1C 

24 

23 

DD 

FD 

2C 

33 

EDAA 

EDBA 

EDA2 

EDB2 

E9 

DDE 9 

FDE9 

DA84 05 

FA84 05 

D28405 

C38405 

C28405 

F28405 

EA84 05 

E28405 

CA84 05 

382E 

182E 

302E 

202E 

282E 

02 

12 

77 

70 

71 

72 

73 



EI 

EX 

EX 

EX 

EX 

EX 

EXX 

HALT 

IM 

IM 

IM 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

INC 

INC 

INC 

INC 

INC 

INC 

INC 

INC 

INC 

INC 

INC 

INC 

INC 

INC 

INC 

INC 

IND 

INDR 

INI 

INIR 

JP 

JP 

JP 

JP 

JP 

JP 

JP 

JP 

JP 

JP 

JP 

JP 

JR 

JR 

JR 

JR 

JR 

LD 

LD 

LD 

LD 

LD 

LD 

LD 



(SP) , IX 
(SP) , IY 
AF , AF ' 
DE,HL 
SP) ,HL 





1 

2 

A, 

A, 

C, 

D, 

E, (C) 

H, (C) 

H, (C) 

L, (C) 

(F. 

(I 

(I 

A 

B 

BC 

C 

D 

DE 
E 
H 



(HL) ,A 
(HL) ,B 



(HL) ,E 



OPCODE 


SOURCE 


CODE 




74 


LD 


HL) ,H 




75 


LD 


HL) ,L 




3620 


LD 


HL) ,N 




DD7705 


LD 


IX+IND) 


,A 


DD7005 


LD 


IX+IND) 


,B 


DD7105 


LD 


IX+IND) 


,c 


DD7205 


LD 


IX+IND) 


,D 


DD7305 


LD 


IX+IND) 


,E 


DD7405 


LD 


IX+IND) 


,H 


DD7505 


LD 


IX+IND) 


,L 


DD360520 


LD 


IX+IND) 


,N 


FD7705 


LD 


IY+IND) 


,A 


FD7005 


LD 


IY+IND) 


,B 


FD7105 


LD 


IY+IND) 


,c 


FD7205 


LD 


IY+IND) 


,D 


FD7305 


LD 


IY+IND) 


,E 


FD7405 


LD 


IY+IND) 


,H 


FD7505 


LD 


IY+IND) 


,L 


FD360520 


LD 


IY+IND) 


,N 


328405 


LD 


NN) ,A 




ED438405 


LD 


NN) ,BC 




ED538405 


LD 


NN) ,DE 




228405 


LD 


NN) ,HL 




DD228405 


LD 


NN) , IX 




FD225405 


LD 


NN) , IY 




ED738405 


LD 


NN) , SP 





OPCODE 



SOURCE CODE 



23 


INC 


HL 


DD2 3 


INC 


IX 


FD2 3 


INC 


IY 


2C 


INC 


L 


33 


INC 


SP 



0A 

1A 

7E 

DD7E05 

FD7E05 

3A8405 

7F 

78 



LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 



(IY+IND) 
(NN) 



45 


LD 


B,L 


0620 


LD 


B,N 


ED4B8405 


LD 


BC, (NN) 


018405 


LD 


BC,NN 


4E 


LD 


C, (HL) 



LD 
LD 



LD 



LD 
LD 
LD 
LD 
LD 



D,D 
D.E 



LD D,H 

LD D,L 

LD D,N 

LD DE, (NN) 

LD DE , NN 

LD E, (HL) 

LD E, (IX+IND) 

LD E, (IY+IND) 



E,A 



LD 

LD H,B 

LD H,C 

LD H,D 

LD H,E 

LD H,H 



E,N 

H, (HL) 

H, (IX±IND) 

H, (IY+IND) 

H,A 



LD 

LD L,C 

LD L,D 

LD L,E 

LD L,H 

LD L,L 

LD L,N 



IX, (NN) 

IX, NN 

IY, (NN) 

IY,NN 

L, (HL) 

L, (IX+IND) 

L, (IY+IND) 

L,A 

L,B 



SP, (NN) 

SP,HL 
SP, IX 
SP, IY 
SP,NN 



EDA5 


LDD 


EDB8 


LDDR 



24 



OPCODE 


SOURCE CODE 


EDBO 


LDIR 


ED44 


NEG 


00 


NOP 


B6 


OR (HL) 


DDB605 


OR (IX+IND) 



OPCODE 



SOURCE CODE 



OPCODE 



SOURCE CODE 



FDB605 
B7 

BO 
Bl 
B2 





OR 


E 




OR 


H 


B5 


OR 


L 


F620 


OR 


N 


EDBB 


OTDR 





EDB3 

ED7 9 

ED41 

ED4 9 

ED5 

ED5 

ED6 

ED6 

D32 

EDA 

EDA3 

Fl 

CI 

Dl 

El 



E5 

DDE 5 
FDE5 



OR 

OR 

OR 

OR 

OR 

OR 

OR 

OR 

OR 

OTT 

OTIR 

OUT 

OUT 

OUT 

OUT 

OUT 

OUT 

OUT 

OUT 

OUT! 

OUT I 

POP 

POP 

POP 

POP 



(IY+IND) 



(C) ,A 
(C) ,B 
(C) ,C 



ED51 


OUT 


(C) ,D 


ED5 9 


OUT 


(C) ,E 


ED61 


OUT 


(C) ,H 


ED6 9 


OUT 


(C) ,L 


D320 


OUT 


N,A 


EDAB 


OUTD 





AF 
BC 
DE 

HL 



DDE1 


POP IX 


FDE1 


POP IY 


F5 


PUSH AF 


C5 


PUSH BC 




PUSH DE 



PUSH 
PUSH 
PUSH 



HL 
IX 
IY 



CB86 


RES 





(HL) 


DDCB0556 


RES 





(IX+IND) 


FDCB0586 


RES 





(IY+IND) 


CB87 


RES 





A 


CB80 


RES 





B 


CB81 


RES 





C 


CB82 


RES 





D 


CB83 


RES 





E 


CB84 


RES 





H 


CB85 


RES 





L 


CB8E 


RES 


1 


(HL) 


DDCB055E 


RES 


1 


(IX+IND) 


FDCB055E 


RES 


1 


(IY+IND) 


CB8F 


RES 


1 


A 


CB8 8 


RES 


1 


B 


CB8 9 


RES 


1 


C 


CB8A 


RES 


1 


D 


CB8B 


RES 


1 


E 


CB8C 


RES 


1 


H 


CB8D 


RES 


1 


L 


CB96 


RES 


2 


(HL) 


DDCB0596 


RES 


2 


(IX+IND) 


FDCB0596 


RES 


2 


(IY+IND) 


CB97 


RES 


2 


A 


CB90 


RES 


2 


B 



CB91 


RES 


2, 


CB92 


RES 


2, 


CB93 


RES 


2, 


CB94 


RES 


2, 


CB95 


RES 


2, 


CB9E 


RES 


3, 


DDCB059E 


RES 


3, 


FDCB059E 


RES 


3, 


CB9F 


RES 


3, 


CB98 


RES 


3, 


CB99 


RES 


3, 


CB9A 


RES 


3, 


CB9B 


RES 


3, 


CB9C 


RES 


3, 


CB9D 


RES 


3, 


CBA6 


RES 


4, 


DDCB05A6 


RES 


4, 


FDCB05A6 


RES 


4, 


CBA7 


RES 


4, 


CBAO 


RES 


4, 


CBA1 


RES 


4, 


CBA2 


RES 


4, 


CBA3 


RES 


4, 


CBA4 


RES 


4, 


CBA5 


RES 


4, 


CBAE 


RES 


5, 


DDCB05AE 


RES 


5, 


FDCB05AE 


RES 


5, 


CBAF 


RES 


5, 


CBA8 


RES 


5, 


CBA9 


RES 


5, 


CBAA 


RES 


5, 


CBAB 


RES 


5, 


CBAC 


RES 


5, 


CBAD 


RES 


5, 


CBB6 


RES 


6, 


DDCB05B6 


RES 


6, 


FDCB05B6 


RES 


6, 


CBB7 


RES 


6, 


CBBO 


RES 


6, 


CBB1 


RES 


6, 


CBB2 


RES 


6, 


CBB3 


RES 


6, 


CBB4 


RES 


6, 


CBB5 


RES 


6, 


CBBE 


RES 


7, 


DDCB05BE 


RES 


7, 


FDCB05BE 


RES 


7, 


CBBF 


RES 


7, 


CBB8 


RES 


7, 


CBB9 


RES 


7, 


CBBA 


RES 


7, 


CBBB 


RES 


7, 


CBBC 


RES 


7, 


CBBD 


RES 


7, 


C9 


RET 




D8 


RET 


C 


F8 


RET 


M 


DO 


RET 


NC 


CO 


RET 


NZ 


F0 


RET 


P 


E8 


RET 


PE 




RET 


PO 




A 

B 

C 

D 

E 

H 

L 

(HL) 

(IX+IND) 
(IY+IND) 

A 

B 

C 

D 

E 

H 

L 




A 

B 

C 

D 

E 

H 

L 

(HL) 

(IX+IND) 
(IY+IND) 

A 

B 

C 

D 

E 

H 

L 

(HL) 

(IX+IND) 
(IY+IND) 

A 

B 

C 

D 

E 

H 

L 



CB13 


RL 


E 


CB14 


RL 


H 


CB15 


RL 


L 


17 


RLA 




CB06 


RLC 


(HL) 



CB02 


RLC 


D 


CB03 


RLC 


E 


CB04 


RLC 


H 


CB05 


RLC 


L 


07 


RLCA 





C8 

ED4D 

ED45 

CB16 

DDCB0516 

FDCB0516 

CB17 

CB10 

CB11 

CB12 

CB13 

CB14 

CB15 

17 

CB06 

DDCB0506 

FDCB0506 

CB07 

CB00 

CB01 

CB02 

CB03 

CB04 

CB05 

07 

ED6F 

FDCB051E 

CB18 

CB19 

CB1A 

CB 

CB 

CB 

CB 

DD 

IF 

CB1F 

CBOE 

DDCB050E 

FDCB 

CBOF 

CB08 

CB09 

CBOA 

CBOB 

CBOC 

CBOD 

OF 

ED6 7 

C7 

D7 

DF 

E7 

EF 

F7 

FF 

CF 

9E 

DD9E05 

FD9E05 

9F 

98 

99 



RET 

RETI 

RETN 

RL 

RL 

RL 

RL 

RL 

RL 

RL 

RL 

RL 

RL 

RL? 

RLC 

RLC 

RLC 

RLC 

RLC 

RLC 

RLC 

RLC 

RLC 

RLC 

RLC/ 

RLD 

RR 

RR 

RR 

RR 

RR 

RR 

RR 

RR 

RRi 

RRA 

RRA 

RRC 

RRC 

RRC 

RRC 

RRC 

RRC 

RRC 

RRC 

RRC 

RRC 

RRCA 

RRD 



(HL) 

(IX+IND) 

(IY+IND) 






(IX+IND) 
(IY+IND) 



(IY+IND) 



CB1B 


RR 


E 


CB1C 


RR 


H 


CB1D 


RR 


L 


CB1E 


RR 


(HL) 


DDCB051E 


RR(IX 


+ IND) 



(HL) 
(IX+IND) 



FDCB050E 


RRC 


(IY+IND) 


CBOF 


RRC 


A 


CB08 


RRC 


B 


CB09 


RRC 


C 


CBOA 


RRC 


D 


CBOB 


RRC 


E 



C7 


RST 





D7 


RST 


10H 


DF 


RST 


18H 


E7 


RST 


20H 


EF 


RST 


28H 


F7 


RST 


30H 



RST 38H 

RST 8 

SBC A, (HL) 

SBC A, (IX+IND 

SBC A, (IY+IND 

SBC A, A 

SBC A,B 

SBC A,C 



IND) 
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OPCODE 


SOURCE CODE 


9A 


SBC 


A,D 


9B 


SBC 


A,E 


9C 


SBC 


A,H 


9D 


SBC 


A,L 


DE20 


SBC 


A,N 



OPCODE 



SOURCE CODE 



ED42 
ED52 
ED62 
ED72 
37 



SBC 
SBC 
SBC 
SBC 
SCF 



HL,BC 
HL,DE 
HL,HL 
HL,SP 



CBC6 


SET 





(HL) 


DDCB05C6 


SET 





(IX+IND) 


FDCB05C6 


SET 





(IY+IND) 


CBC7 


SET 





A 


CBCO 


SET 





B 


CBC1 


SET 





C 


CBC2 


SET 





D 


CBC3 


SET 





E 


CBC4 


SET 





H 


CBC5 


SET 





L 


CBCE 


SET 


1 


(HL) 


DDCB05CE 


SET 


1 


(IX+IND) 


FDCB05CE 


SET 


1 


(IY+IND) 


CBCF 


SET 


1 


A 


CBC8 


SET 


1 


B 


CBC9 


SET 


1 


C 


CBCA 


SET 


1 


D 


CBCB 


SET 


1 


E 


CBCC 


SET 


1 


H 


CBCD 


SET 


1 


L 


CBD6 


SET 


2 


(HL) 


DDCB05D6 


SET 


2 


(IX+IND) 


FDCB05D6 


SET 


2 


(IY+IND) 


CBD7 


SET 


2 


A 


CBDO 


SET 


2 


B 


CBD1 


SET 


2 


C 


CBD2 


SET 


2 


D 


CBD3 


SET 


2 


E 


CBD4 


SET 


2 


H 


CBD5 


SET 


2 


L 


CBDE 


SET 


3 


(HL) 


DDCB05DE 


SET 


3 


(IX+IND) 


FDCB05DE 


SET 


3 


(IY+IND) 


CBDF 


SET 


3 


A 


CBD8 


SET 


3 


B 


CBD9 


SET 


3 


C 


CBDA 


SET 


3 


D 


CBDB 


SET 


3 


E 


CBDC 


SET 


3 


H 


CBDD 


SET 


3 


L 



CBE6 


SET 


4 


DDCB05E6 


SET 


4 


FDCB05E6 


SET 


4 


CBE7 


SET 


4 


CBEO 


SET 


4 


CBE1 


SET 


4 


CBE2 


SET 


4 


CBE3 


SET 


4 


CBE4 


SET 


4 


CBE5 


SET 


4 


CBEE 


SET 


5 


DDCB05EE 


SET 


5 


FDCB05EE 


SET 


5 


CBEF 


SET 


5 


CBE8 


SET 


5 


CBE9 


SET 


5 


CBEA 


SET 


5 


CBEB 


SET 


5 


CBEC 


SET 


5 


CBED 


SET 


5 


CBF6 


SET 


6 


DDCB05F6 


SET 


6 


FDCB05F6 


SET 


6 


CBF7 


SET 


6 


CBFO 


SET 


6 


CBF1 


SET 


6 


CBF2 


SET 


6 


CBF3 


SET 


6 


CBF4 


SET 


6 


CBF5 


SET 


6 


CBFE 


SET 


7 


DDCB05FE 


SET 


7 


FDCB05FE 


SET 


7 


CBFF 


SET 


7 


CBF9 


SET 


7 


CBFA 


SET 


7 


CBFB 


SET 


7 


CBF8 


SET 


7 


CBFC 


SET 


7 


CBFD 


SET 


7 


CB2 6 


SLA 


(1 


DDCB0526 


SLA 


( 


FDCB0526 


SLA 


( 


CB2 7 


SLA 


A 


CB2 


SLA 


B 


CB21 


SLA 


C 


CB22 


SLA 


D 


CB23 


SLA 


E 


CB24 


SLA 


H 


CB25 


SLA 


L 



(HL) 

(IX+IND) 

(IY+IND) 



(IY+IND) 



(HL) 

(IX+IND) 

(IY+IND) 



OPCODE 


SOURCE CODE 


CB2E 


SRA 


(HL) 


DDCB052E 


SRA 


(IX+IND) 


FDCB052E 


SRA 


(IY+IND) 


CB2F 


SRA 


A 


CB2 8 


SRA 


B 



CB3E 


SRL 


(HL) 


DDCB053E 


SRL 


(IX+IND) 


FDCB053E 


SRL 


(IY+IND) 


CB3F 


SRL 


A 


CB3 8 


SRL 


B 



CB2 9 

CB2A 

CB2B 

CB2C 

CB2D 

CB3E 

DDCBC 

FDCBC 

CB3F 

CB3 8 

CB3 9 

CB3A 

CB3B 

CB3C 

CB3D 

96 

DDS 

FDS 

97 

90 

91 

92 

93 

94 

95 

D6; 

AE 

dd; 

FDi 

AF 

A8 

A9 
AA 
AB 
AC 



96 


SUB 


(HL) 


DD9605 


SUB 


(IX+IND) 


FD9605 


SUB 


(IY+IND) 


97 


SUB 


A 


90 


SUB 


B 



N 
DIS 



SRA 
SRA 
SRA 
SRA 
SRA 
SRL 
SRL 
SRL 
SRL 
SRL 
SRL 
SRL 
SRL 
SRL 
SRL 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
SUB 
XOR 
XOR 
XOR 
XOR 
XOR 
XOR 
XOR 
XOR 
XOR 
XOR 
XOR 
DEF 
EQU 
EQU 
EQU 
EQU 
END 



C 
D 
E 
H 
L 



C 

D 
E 
H 
L 



D620 


SUB 


N 


AE 


XOR 


(HL) 


DDAE05 


XOR 


(IX+IND) 


FDAE05 


XOR 


(IY+IND) 


AF 


XOR 


A 



AD 


XOR 


L 


EE2 


XOR 


N 


NN 


DEFS 


2 


IND 


EQU 


5 


M 


EQU 


10H 



C 
D 
E 
H 
L 
N 

(t: 
(i 
(i 

A 

B 

C 

D 

E 

H 

L 

N 

2 

5 

1C 

20H 

30H 
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Appendix B. Z-80 Instruction Set 
by Operation Codes 



OPCODE 


SOURCE CODE 


OPCODE 


SOURCE 


CODE 


OPCODE 


SOURCE CODE 


00 


NOP 




3B 


DEC 


SP 




76 


HALT 




018405 


LD 


BC,NN 


3C 


INC 


A 




77 


LD 


(HL) ,A 


02 


LD 


(BC) ,A 


3D 


DEC 


A 




78 


LD 


A.B 




INC 


BC 


3E20 


LD 


A,N 




79 


LD 


A,C 




INC 


B 


3F 


CCF 






7A 


LD 


A,D 


05 


DEC 


B 


40 


LD 


B,B 




7B 


LD 


A,E 


0620 


LD 


B,N 


41 


LD 


B 


c 




7C 


LD 


A,H 


07 


RLCA 




42 


LD 


B 


D 




7D 


LD 


A,L 


08 


EX 


AF , AF ' 


43 


LD 


B 


E 




7E 


LD 


A, (HL) 


09 


ADD 


HL,BC 


44 


LD 


B 


H, 


NN 


7F 


LD 


A, A 






A, (BC) 




LD 


B 


L 




80 


ADD 


A,B 


0B 


DEC 


BC 


46 


LD 


B 


(HL) 


81 


ADD 


A,C 


OC 


INC 


c 


47 


LD 


B 


A 




82 


ADD 


A,D 


OD 


DEC 


C 


48 


LD 


C 


B 




83 


ADD 


A,E 


0E20 


LD 


C,N 




LD 


C 


C 




84 


ADD 


A,H 


OF 


RRCA 




4A 


LD 


C 


D 




85 


ADD 


A,L 


102E 


DJNZ 


DIS 


4B 


LD 


C 


E 




86 


ADD 


A, (HL) 


118405 


LD 


DE,NN 


4C 


LD 


C 


H 




87 


ADD 


A,A 


12 


LD 


(DE) ,A 


4D 


LD 


C 


L 




88 


ADC 


A,B 


13 


INC 


DE 


4E 


LD 


c 


(HL) 


89 


ADC 


A,C 




INC 


D 




LD 


c 


A 




8A 


ADC 


A,D 


15 


DEC 


D 


50 


LD 


D 


B 




8B 


ADC 


A,E 


1620 


LD 


D,N 


51 


LD 


D 


C 




8C 


ADC 


A,H 


17 


RLA 




52 


LD 


D 


D 




8D 


ADC 


A,L 


182E 


JR 


DIS 




LD 


D 


E 




8E 


ADC 


A, (HL) 


19 


ADD 


HL,DE 


54 


LD 


D 


H 




8F 


ADC 


A,A 


1A 


LD 


A, (DE) 


55 


LD 


D 


L 




90 


SUB 


B 


IB 


DEC 


DE 


56 


LD 


D 


(HL) 


91 


SUB 


C 


1C 


INC 


E 


57 


LD 


D 


A 




92 


SUB 


D 


ID 


DEC 


E 


58 


LD 


E 


B 




93 


SUB 


E 


1E20 


LD 


E,N 




LD 


E 


C 




94 


SUB 


H 


IF 


RRA 






LD 


E 


D 




95 


SUB 


L 


202E 


JR 


NZ,DIS 


5B 


LD 


E 


E 




96 


SUB 


(HL) 


218405 


LD 


HL,NN 




LD 


E 


H 




97 


SUB 


A 


228405 


LD 


(NN) ,HL 




LD 


E 


L 




98 


SBC 


A,B 


23 


INC 


HL 


5E 


LD 


E 


(HL) 


99 


SBC 


A,C 


24 


INC 


H 


5F 


LD 


E 


A 




9A 


SBC 


A,D 


25 


DEC 


H 


60 


LD 


H 


B 




9B 


SBC 


A,E 


2620 


LD 


H,N 


61 


LD 


H 


C 




9C 


SBC 


A,H 


27 


DAA 




62 


LD 


H 


D 




9D 


SBC 


A,L 


282E 


JR 


Z,DIS 




LD 


H 






9E 


SBC 


A, (HL) 


29 


ADD 


HL,HL 


64 


LD 


H 


H 




9F 


SBC 


A,A 


2A8405 


LD 


HL, (NN) 


65 


LD 


H 


L 




A0 


AND 


B 


2B 


DEC 


HL 


66 


LD 


H 


(HL) 


Al 


AND 


C 




INC 


L 




LD 


H 


A 




A2 


AND 


D 


2D 


DEC 


L 


68 


LD 


L 


B 




A3 


AND 


E 


2E20 


LD 


L,N 


69 


LD 


L 


C 




A4 


AND 


H 


2F 


CPL 




6A 


LD 


L 


D 




A5 


AND 


L 


302E 


JR 


NC,DIS 


6B 


LD 


L 


E 




A6 


AND 


(HL) 


318405 


LD 


SP,NN 


6C 


LD 


L 


H 




A7 


AND 


A 


328405 


LD 


(NN) ,A 




LD 


L 


L 




A8 


XOR 


B 


33 


INC 


SP 


6E 


LD 


L 


(HL) 


A9 


XOR 


C 


34 


INC 


(HL) 


6F 


LD 


L 


A 




AA 


XOR 


D 


35 


DEC 


(HL) 


70 


LD 


(HL) 


,B 


AB 


XOR 


E 


3620 


LD 


(HL) ,N 




LD 


(HL) 


,c 


AC 


XOR 


H 


37 


SCF 




72 


LD 


(HL) 


,D 


AD 


XOR 


L 


382E 


JR 


C,DIS 


73 


LD 


(HL) 


,E 


AE 


XOR 


(HL) 


39 


ADD 


HL,SP 


74 


LD 


(HL) 


,H 


AF 


XOR 


A 


3A8405 


LD 


A, (NN) 


75 


LD 


(I 


IL) 


,L 


B0 


OR 


B 
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OPCODE 


SOURCE CODE 


OPCODE 


SOURCE CODE 


OPCODE 


SOURCE 


CODE 


Bl 


OR 


c 


F3 


DI 




CB3B 


SRL 


E 


B2 


OR 


D 


F48405 


CALL 


P,NN 


CB3C 


SRL 


H 


B3 


OR 


E 


F5 


PUSH 


AF 


CB3D 


SRL 


L 


B4 


OR 


H 


F620 


OR 


N 


CB3E 


SRL 


(HL) 


B5 


OR 


L 


F7 


RST 


30H 


CB3F 


SRL 


A 


B6 


OR 


(HL) 


F8 


RET 


M 


CB40 


BIT 


0,B 


B7 


OR 


A 


F9 


LD 


SP,HL 


CB41 


BIT 





C 


B8 


CP 


H 


FA84 05 


JP 


M,NN 


CB42 


BIT 





D 


B9 


CP 


C 


EB 


El 




CB43 


BIT 





E 


BA 


CP 


D 


FC8405 


CALL 


M,NN 


CB44 


BIT 





H 


BB 


CP 


E 


FE2 


CP 


N 


CB45 


BIT 





L 


BC 


CP 


H 


FF 


RST 


38H 


CB46 


BIT 





(HL) 


BD 


CPL 




CBOO 


RLC 


B 


CB47 


BIT 





A 


BE 


CP 


(HL) 


CB01 


RLC 


C 


CB4 8 


BIT 


1 


B 


BF 


CPA 




CB02 


RLC 


D 


CB49 


BIT 


1 


C 


CO 


RET 


NZ 


CB03 


RLC 


E 


CB4A 


BIT 


1 


D 


CI 


POP 


BC 


CB04 


RLC 


H 


CB4B 


BIT 


1 


E 


C28405 


JP 


NZ,NN 


CB05 


RLC 


L 


CB4C 


BIT 


1 


H 


C38405 


JP 


NN 


CB0 6 


RLC 


(HL) 


CB4D 


BIT 


1 


L 


C48405 


CALL 


NZ,NN 


CB07 


RLC 


A 


CB4E 


BIT 


1 


(HL) 


C5 


PUSH 


BC 


CB08 


RRC 


B 


CB4F 


BIT 


1 


A 


C620 


ADD 


A,N 


CB09 


RRC 


C 


CB50 


BIT 


2 


B 


C7 


RST 





CBOA 


RRC 


D 


CB51 


BIT 


2 


C 


C8 


RET 


Z 


CBOB 


RRC 


E 


CB52 


BIT 


2 


D 


C9 


RET 




CBOC 


RRC 


H 


CB53 


BIT 


2 


E 


CA84 05 


JP 


Z,NN 


CBOD 


RRC 


L 


CB54 


BIT 


2 


H 


CC8405 


CALL 


Z,NN 


CBOE 


RRC 


(HL) 


CB55 


BIT 


2 


L 


CD8405 


CALL 


NN 


CBOF 


RRC 


A 


CB5 6 


BIT 


2 


(HL) 


CE2 


ADC 


A,N 


CB10 


RL 


B 


CB5 7 


BIT 


2 


A 


CF 


RST 


8 


CB11 


RL 


C 


CB58 


BIT 


3 


B 


DO 


RET 


NC 


CB12 


RL 


D 


CB59 


BIT 


3 


C 


Dl 


POP 


DE 


CB13 


RL 


E 


CB5A 


BIT 


3 


D 


D28405 


JP 


NC,NN 


CB14 


RL 


H 


CB5B 


BIT 


3 


E 


D320 


OUT 


N,A 


CB15 


RL 


L 


CB5C 


BIT 


3 


H 


D48405 


CALL 


NC,NN 


CB16 


RL 


(HL) 


CB5D 


BIT 


3 


L 


D5 


PUSH 


DE 


CB17 


RL 


A 


CB5E 


BIT 


3 


(HL) 


D620 


SUB 


N 


CB18 


RR 


B 


CB5F 


BIT 


3 


A 


D7 


RST 


10H 


CB19 


RR 


C 


CB6 


BIT 


4 


H 


D8 


RET 


C 


CB1A 


RR 


D 


CB61 


BIT 


4 


C 


D9 


EXX 




CB1B 


RR 


E 


CB62 


BIT 


4 


D 


DA84 05 


JP 


C,NN 


CB1C 


RR 


H 


CB63 


BIT 


4 


E 


DB2 


IN 


A,N 


CB1D 


RR 


L 


CB64 


BIT 


4 


H 


DC8405 


CALL 


C,NN 


CB1E 


RR 


(HL) 


CB65 


BIT 


4 


L 


DE2 


SBC 


A,N 


CB1F 


RRA 




CB66 


BIT 


4 


(HL) 


DF 


RST 


18H 


CB2 


SLA 


B 


CB67 


BIT 


4 


A 


EO 


RET 


PO 


CB21 


SLA 


C 


CB6 8 


BIT 


5 


B 


EI 


POP 


HL 


CB22 


SLA 


D 


CB6 9 


BIT 


5 


C 


E28405 


JP 


PO,NN 


CB23 


SLA 


E 


CB6A 


BIT 


5 


D 


E3 


EX 


SP) .HL 


CB24 


SLA 


H 


CB6B 


BIT 


5 


E 


E48405 


CALL 


PO,NN 


CB2 5 


SLA 


L 


CB6C 


BIT 


5 


H 


E5 


PUSH 


HL 


CB2 6 


SLA 


(HL) 


CB6D 


BIT 


5 


L 


E620 


AND 


N 


CB2 7 


SLA 


A 


CB6E 


BIT 


5 


(HL) 


E7 


RST 


20H 


CB2 8 


SRA 


B 


CB6F 


BIT 


5 


A 


E8 


RET 


PE 


CB2 9 


SRA 


C 


CB70 


BIT 


6 


B 


E9 


JP 


(HL) 


CB2A 


SRA 


D 


CB71 


BIT 


6 


C 


EA84 05 


JP 


PE,NN 


CB2B 


SRA 


E 


CB72 


BIT 


6 


D 


EB 


EX 


DE,HL 


CB2C 


SRA 


H 


CB73 


BIT 


6 


E 


EC8405 


CALL 


PE,NN 


CB2D 


SRA 


L 


CB74 


BIT 


6 


H 


EE2 


XOR 


N 


CB2E 


SRA 


(HL) 


CB75 


BIT 


6 


L 


EF 


RST 


28H 


CB2F 


SRA 


A 


CB76 


BIT 


6 


(HL) 


FO 


RET 


P 


CB38 


SRL 


B 


CB7 7 


BIT 


6 


A 


Fl 


POP 


AF 


CB39 


SRL 


C 


CB78 


BIT 


7 


B 


F28405 


JP 


P,NN 


CB3A 


SRL 




CB79 


BIT 


7 


C 



28 



OPCODE 


SOURCE 


CODE 


CB7A 


BIT 


7,D 


CB7B 


BIT 


7 


E 


CB7C 


BIT 


7 


H 


CB7D 


BIT 


7 


L 


CB7E 


BIT 


7 


(HL) 


CB7F 


BIT 


7 


A 


CB8 


RES 





B 


CB81 


RES 





C 


CB82 


RES 





D 


CB83 


RES 





E 


CB84 


RES 





H 


CB85 


RES 





L 


CB86 


RES 





(HL) 


CB87 


RES 





A 


CB8 8 


RES 


1 


B 


CB89 


RES 


1 


C 


CB8A 


RES 


1 


D 


CB8B 


RES 


1 


E 


CB8C 


RES 


1 


H 


CB8D 


RES 


1 


L 


CB8E 


RES 


1 


(HL) 


CB8F 


RES 


1 


A 


CB90 


RES 


2 


B 


CB91 


RES 


2 


C 


CB92 


RES 


2 


D 


CB93 


RES 


2 


E 


CB94 


RES 


2 


H 


CB95 


RES 


2 


L 


CB96 


RES 


2 


(HL) 


CB97 


RES 


2 


A 


CB98 


RES 


3 


B 


CB99 


RES 


3 


C 


CB9A 


RES 


3 


D 


CB9B 


RES 


3 


E 


CB9C 


RES 


3 


H 


CB9D 


RES 


3 


L 


CB9E 


RES 


3 


(HL) 


CB9F 


RES 


3 


A 


CBAO 


RES 


4 


B 


CBA1 


RES 


4 


C 


CBA2 


RES 


4 


D 


CBA3 


RES 


4 


E 


CBA4 


RES 


4 


H 


CBA5 


RES 


4 


L 


CBA6 


RES 


4 


(HL) 


CBA7 


RES 


4 


A 


CBA8 


RES 


5 


B 


CBA9 


RES 


5 


C 


CBAA 


RES 


5 


D 


CBAB 


RES 


5 


E 


CBAC 


RES 


5 


H 


CBAD 


RES 


5 


L 


CBAE 


RES 


5 


(HL) 


CBAF 


RES 


5 


A 


CBBO 


RES 


6 


B 


CBB1 


RES 


6 


C 


CBB2 


RES 


6 


D 


CBB3 


RES 


6 


E 


CBB4 


RES 


6 


H 


CBB5 


RES 


6 


L 


CBB6 


RES 


6 


(HL) 


CBB7 


RES 


6 


A 




RES 


7 


B 



OPCODE 


SOURCE 


CODE 


CBB9 


RES 


7,C 


CBBA 


RES 


7 


D 


CBBB 


RES 


7 


E 


CBBC 


RES 


7 


H 


CBBD 


RES 


7 


L 


CBBE 


RES 


7 


(HL) 


CBBF 


RES 


7 


A 


CBCO 


SET 





B 


CBC1 


SET 





C 


CBC2 


SET 





D 


CBC3 


SET 





E 


CBC4 


SET 





H 


CBC5 


SET 





L 


CBC6 


SET 





(HL) 


CBC7 


SET 





A 


CBC8 


SET 


1 


B 


CBC9 


SET 


1 


C 


CBCA 


SET 


1 


D 


CBCB 


SET 


1 


E 


CBCC 


SET 


1 


H 


CBCD 


SET 


1 


L 


CBCE 


SET 


1 


(HL) 


CBCF 


SET 


1 


A 


CBDO 


SET 


2 


B 


CBD1 


SET 


2 


C 


CBD2 


SET 


2 


D 


CBD3 


SET 


2 


E 


CBD4 


SET 


2 


H 


CBD5 


SET 


2 


L 


CBD6 


SET 


2 


(HL) 


CBD7 


SET 


2 


A 


CBD8 


SET 


3 


B 


CBD9 


SET 


3 


C 


CBDA 


SET 


3 


D 


CBDB 


SET 


3 


E 


CBDC 


SET 


3 


H 


CBDD 


SET 


3 


L 


CBDE 


SET 


3 


(HL) 


CBDF 


SET 


3 


A 


CBEO 


SET 


4 


B 


CBE1 


SET 


4 


C 


CBE2 


SET 


4 


D 


CBE3 


SET 


4 


E 


CBE4 


SET 


4 


H 


CBE5 


SET 


4 


L 


CBE6 


SET 


4 


(HL) 


CBE7 


SET 


4 


A 


CBE8 


SET 


5 


B 


CBE9 


SET 


5 


C 


CBEA 


SET 


5 


D 


CBEB 


SET 


5 


E 


CBEC 


SET 


5 


H 


CBED 


SET 


5 


L 


CBEE 


SET 


5 


(HL) 


CBEF 


SET 


5 


A 


CBFO 


SET 


6 


B 


CBF1 


SET 


6 


C 


CBF2 


SET 


6 


D 


CBF3 


SET 


6 


E 


CBF4 


SET 


6 


H 


CBF5 


SET 


6 


L 


CBF6 


SET 


6 


(HL) 


CBF7 


SET 


6 


A 



OPCODE 


SOURCE CODE 


CBF8 


SET 


7,H 


CBF9 


SET 


7,C 


CBFA 


SET 


7,D 


CBFB 


SET 


7,E 


CBFC 


SET 


7,H 


CBFD 


SET 


7,L 


CBFE 


SET 


7, (HL) 


CBFF 


SET 


7,A 


DD0 9 


ADD 


IX, BC 


DD19 


ADD 


IX, DE 


DD218405 


LD 


IX, NN 


DD228405 


LD 


(NN) , IX 


DD2 3 


INC 


IX 


DD2 9 


ADD 


IX, IX 


DD2A84 05 


LD 


IX, (NN) 


DD2B 


DEC 


IX 


DD3405 


INC 


(IX+IND) 


DD3505 


DEC 


(IX+IND) 


DD360520 


LD 


(IX+IND) ,N 


DD3 9 


ADD 


IX, SP 


DD4605 


LD 


B, (IX+IND) 


DD4E05 


LD 


C, (IX+IND) 


DD5605 


LD 


D, (IX+IND) 


DD5E05 


LD 


E. (IX+IND) 


DD6605 


LD 


H, (IX+IND) 


DD6E05 


LD 


L, (IX+IND) 


DD7005 


LD 


(IX+IND) ,B 


DD7105 


LD 


(IX+IND) , C 


DD7205 


LD 


(IX+IND) ,D 


DD7305 


LD 


(IX+IND) ,E 


DD7405 


LD 


(IX+IND) ,H 


DD7505 


LD 


(IX+IND) ,L 


DD7705 


LD 


(IX+IND) ,A 


DD7E05 


LD 


A, (IX+IND) 


DD8605 


ADD 


A, (IX+IND) 


DD8E05 


ADC 


A, (IX+IND) 


DD9605 


SUB 


(IX+IND) 


DD9E05 


SBC 


A, (IX+IND) 


DDA6 05 


AND 


(IX+IND) 


DDAE05 


XOR 


(IX+IND) 


DDB605 


OR 


(IX+IND) 


DDBE05 


CP 


(IX+IND) 


DDE1 


POP 


IX 


DDE3 


EX 


(SP) , IX 


DDE 5 


PUSH 


IX 


DDE 9 


JP 


(IX) 


DDF9 


LD 


SP, IX 


DDCB0506 


RLC 


(IX+IND) 


DDCB050E 


RRC 


(IX+IND) 


DDCB0516 


RL 


(IX+IND) 


DDCB051E 


RR(IX+IND) 


DDCB0526 


SLA 


(IX+IND) 


DDCB052E 


SRA 


(IX+IND) 


DDCB053E 


SRL 


(IX+IND) 


DDCB0546 


BIT 


0, (IX+IND) 


DDCB054E 


BIT 


1, (IX+IND) 


DDCB0556 


BIT 


2, (IX+IND) 


DDCB055E 


BIT 


3, (IX+IND) 


DDCB0566 


BIT 


4, (IX+IND) 


DDCB056E 


BIT 


5, (IX+IND) 


DDCB0576 


BIT 


6, (IX+IND) 


DDCB057E 


BIT 


7, (IX+IND) 


DDCB0556 


RES 


0, (IX+IND) 
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OPCODE 


SOURCE CODE 


DDCB055E 


RES 


1, 


(IX+IND) 


DDCB0596 


RES 


2, 


(IX+IND) 


DDCB059E 


RES 


3, 


(IX+IND) 


DDCB05A6 


RES 


4, 


(IX+IND) 


DDCB05AE 


RES 


5, 


(IX+IND) 


DDCB05B6 


RES 


6, 


(IX+IND) 


DDCB05BE 


RES 


7, 


(IX+IND) 


DDCB05C6 


SET 


0, 


(IX+IND) 


DDCB05CE 


SET 


1, 


(IX+IND) 


DDCB05D6 


SET 


2, 


(IX+IND) 


DDCB05DE 


SET 


3, 


(IX+IND) 


DDCB05E6 


SET 


4, 


(IX+IND) 


DDCB05EE 


SET 


5, 


(IX+IND) 


DDCB05F6 


SET 


6, 


(IX+IND) 


DDCB05FE 


SET 


7, 


(IX+IND) 


ED4 


IN 


H, 


(C) 


ED41 


OUT 


(C 


) ,B 



ED45 


RETN 




ED4 6 


IM 





ED4 7 


LD 


I, A 


ED45 


IN 


C, (C) 


ED4 9 


OUT 


(C) ,c 



ED42 

ED438405 

ED44 

ED45 

ED4 6 

ED47 

ED45 

ED4 9 

ED4A 

ED4B8405 

ED4D 

ED5 

ED51 

ED52 

ED53S 

ED5 6 

ED5 7 

ED5 8 

ED5 9 

ED5A 

ED5B8405 

ED5E 

ED6 

ED61 

ED62 

ED6 7 

ED65 

ED6 9 

ED6A 

ED6F 

ED72 

ED738405 



SBC 

LD 

NEG 

RET 

IM 

LD 

IN 

OUT 

ADC 

LD 

RETI 

IN 

OUT 

SBC 

LD 

IM 

LD 

IN 

OUT 

ADC 

LD 

IM 

IN 

OU 1 

SB 

rr: 

IN 

OU' 
ADC 
RLD 
SBC 

LD 



HL,BC 
(NN) ,BC 



HL,BC 
BC, (NN) 

D, (C) 
(C) ,D 
HL, 
(NK 
1 

\, I 
3, ( 
(C) ,E 
HL,DE 
DE, (NN) 
2 



OPCODE 


SOURCE CODE 


ED7 8 


IN 


A, (C) 


ED7 9 


OUT 


(C) ,A 


ED7A 


ADC 


HL, SP 


ED7B8405 


LD 


SP, (NN) 


EDAO 


LDI 





ED52 


SBC 


HL,DE 


ED538405 


LD 


(NN) , DE 


ED5 6 


IM 


1 


ED5 7 


LD 


A, I 


ED5 8 


IN 


E, (C) 



ED6 


IN 


H, (C) 


ED61 


OUT 


(C) ,H 


ED62 


SBC 


HL,HL 


ED6 7 


RRD 




ED65 


IN 


L, (C) 


ED6 9 


OUT 


(C) ,L 



HL,HL 

HL, SP 
(NN) , SP 



EDA1 

EDA2 

EDA3 

EDA5 

EDA9 

EDAA 

EDAB 

EDBO 

EDB1 

EDB2 

EDB3 

EDB8 

EDB9 

EDBA 

EDBB 

FD09 

FD19 

FD215405 

FD225405 

FD23 

FD2 9 

FD2A84 5 

FD2B 

FD3405 

FD3505 

FD360520 

FD3 9 

FD4605 

FD4E05 

FD5605 

FD5E05 

FD6605 

FD6E05 

FD7005 

FD7105 

FD7205 

FD7305 

FD7405 

FD7505 

FD7705 

FD7E05 

FD8605 

FD8E05 

FD9605 



CPI 

INI 

OUT I 

LDD 

CPD 

IND 

OUTD 

LDIR 

CPIR 

INIR 

OTIR 

LDDR 

CPDR 

INDR 

OTDR 

ADD 

ADD 

LD 

LD 

INC 

ADD 

LD 

DEC 

INC 

DEC 

LD 

ADD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

ADD 

ADC 

SUB 




IY,BC 
IY,DE 
IY,NN 
(NN) , IY 
IY 

IY, IY 
IY, (NN) 
IY 

(IY+IND) 
(IY+IND) 
(IY+IND) ,N 
IY, SP 
B, (IY+IND) 
C, (IY+IND) 
D, (IY+IND) 
E, (IY+IND) 
H, (IY+IND) 
L, (IY+IND) 
(IY+IND) ,B 
(IY+IND) ,C 
(IY+IND) ,D 
(IY+IND) ,E 
(IY+IND) ,H 
(IY+IND) ,L 
(IY+IND) ,A 
A, (IY+IND) 
A, (IY+IND) 
A, (IY+IND) 
(IY+IND) 



OPCODE 


SOURCE CODE 


FD9E05 


SBC A, (IY+IND) 


FDA6 05 


AND (IY+IND) 


FDAE05 


XOR (IY+IND) 


FDB605 


OR (IY+IND) 


FDBE05 


CP (IY+IND) 



FDE1 

FDE3 

FDE5 

FDE9 

FDF9 

FDCB0506 

FDCB050E 

FDCB0516 

FDCB051E 

FDCB0526 

FDCB052E 

FDCB053E 

FDC1 

FDC 

fdc: 

FDC 

fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 
fdc: 

NN 

IND 

M 

N 

DIS 



POP 

EX 



IY 

(SP) ,IY 



PUSH IY 
JP (IY) 



LD 

RLC 

RRC 

RL 

RR 

SLA 

SRA 

SRL 

BIT 

BIT 

BIT 

BIT 

BIT 

BIT 

BIT 

BIT 

RES 

RES 

RES 

RES 

RES 

RES 

RES 

RES 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

SET 

DEF 

EQU 

EQU 

EQU 

EQU 

END 



SP, IY 
(IY+IND) 
(IY+IND) 
(IY+IND) 
(IY+IND) 
(IY+IND) 
(IY+IND) 
(IY+IND) 



I 



FDCB0546 


BIT 


0, 


IY+IND) 


FDCB054E 


BIT 


1, 


IY+IND) 


FDCB0556 


BIT 


2, 


IY+IND) 


FDCB055E 


BIT 


3, 


IY+IND) 


FDCB0566 


BIT 


4, 


IY+IND) 


FDCB056E 


BIT 


5, 


IY+IND) 


FDCB0576 


BIT 


6, 


IY+IND) 


FDCB057E 


BIT 


7, 


IY+IND) 


FDCB0586 


RES 


0, 


IY+IND) 


FDCB055E 


RES 


1, 


IY+IND) 


FDCB0596 


RES 


2, 


IY+IND) 


FDCB059E 


RES 


3, 


IY+IND) 


FDCB05A6 


RES 


4, 


IY+IND) 


FDCB05AE 


RES 


5, 


IY+IND) 


FDCB05B6 


RES 


6, 


IY+IND) 


FDCB05BE 


RES 


7, 


IY+IND) 


FDCB05C6 


SET 


0, 


IY+IND) 


FDCB05CE 


SET 


1, 


IY+IND) 


FDCB05D6 


SET 


2, 


IY+IND) 


FDCB05DE 


SET 


3, 


IY+IND) 


FDCB05E6 


SET 


4, 


IY+IND) 


FDCB05EE 


SET 


5, 


IY+IND) 


FDCB05F6 


SET 


6, 


IY+IND) 


FDCB05FE 


SET 


7, 


IY+IND) 


NN 


DEFS 


2 




IND 


EQU 


5 




M 


EQU 


101 


I 


N 


EQU 


201 


I 



30H 
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Appendix C. TRS-80 LEVEL I Memory Map 



ADDRESS 






DECIMAL 


HEXADECIMAL 


CONTENTS 







0000 


LEVEL I BASIC ROM 


4095 




OFFF 


LEVEL I BASIC ROM 


4096 




1000 


Not Used 


14335 




37FF 




14336 




3800 


Keyboard Memory 


15359 




3BFF 




15360 




3 COO 


Video Monitor Memory 


16383 




3FFF 





RAM MEMORY BEGINS 




16384 


4000 


Begin Level I Scratchpad Storage 


16488 
16489 


4068 
4069 


Pointer to Current Cursor Position (LSB) 
Pointer to Current Cursor Position (MSB) 


16490 
16491 


406A 
406B 


Pointer to End of RAM Memory (LSB) 
Pointer to End of RAM Memory (LSB) 


16492 
16493 


406C 
406D 


Pointer to Beginning of Free MEM (LSB) 

Pointer to Beginning of Free MEM (MSB) Preset to 42001 


16528 


4090 


I/O Status Byte 


16894 


41FF 


End of Level I Scratchpad Storage 


16895 


4200 


BASIC Program Storage 


20479 


4FFF 


End of 4K Memory 


32767 


7FFF 


End of 1 6K Memory 


49151 


BFFF 


End of 32K Memory 


65535 


FFFF 


End of 48K Memory 
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Appendix D. LEVEL II Memory Map 



ADDRESS 
DECIMAL HEXADECIMAL 



CONTENTS 







12288 



14302 
14303 
14304 
14305 
14308 
14312 
14316 



14336 



15360 



16383 
16384 



16402 
16405 



16413 



16421 



0000 



3000 



** LEVELII BASIC ROM 



37DE 
37DF 
37E0 

37E1 
37E4 
37E8 
37EC 



3800 



3000 



3FFF 

4000 



4012 
4015 



401D 



4025 



Reserved 



Communication Status Address 

Communication Data Address 

Interrupt Latch Address 

Disk Drive Select Latch Address 

Cassette Select Latch Address 

Line Printer Address 

Floppy Disk Controller Address 



TRS-80 Keyboard 
Memory 



TRS-80 CRT 
Video Memory 



LEVEL II BASIC Fixed RAM 



Vectors (RST'S 1 Through 7) 



Keyboard Device Control Block 

DCB +0 = DCBType 

+ 1 = Driver Address 

+ 2 = Driver Address 

+ 3=0 

+ 4 = 

+ 5 = 

+ 6 = 'K' 

+ 7 = T 

Video Display Control Block 

DCB + = DCB Type 

+ 1 = Driver Address (LSB) 
+ 2 = Driver Address (MSB) 
+ 3 = Cursor POS N (LSB) 
+ 4 = Cursor POS N (MSB) 
+ 5 = Cursor Character 
+ 6 = 'D' 
+ 7 = 'O' 

Line Printer Control Block 

DCB + = DCB Type 

+ 1 = Driver Address (LSB) 

+ 2 = Driver Address (MSB) 

+ 3 = Line/Page 

+ 4 = Line Counter 

+ 5=0 

+ 6 = 'P' 

+ 7 = 'R' 
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16429 

16463 
16464 
16466 
16468 
16476 
16478 
16512 



16870 
17127 
17129 



17128 



20479 
32767 
49151 
65535 



402D 

404F 
4050 
4052 
4054 
405C 
405E 



4080 



41E6 
42E7 
42E9 



42E8 



4FFF 

7FFF 
BFFF 
FFFF 



C 



c 



Reserved 



FDC Interrupt Vector 
Communications Interrupt Vector 

Reserved 

25 MSec Heartbeat Interrupt 
Reserved 



LEVEL II BASIC Free RAM 



Reserved 



I/O Buffer 



Always Zero 



♦ Program Text 



\ Simple Variables 



I Arrays 



\ String Variable Names and Overhead 



Free Memory 



T Stack 



t String Space 



Space Reserved For Machine Language 
Routines — If Memory Size Set, during 
Initialization Dialog 



End of 4K Memory 
End of 16K Memory 
End of 32K Memory 
End of 48K Memory 
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Appendix E. ROM Address and Subroutines 

LEVEL I BASIC Addresses 



KEYBOARD SCAN 




WAIT 


CALL 


0B40H ;SCAN 


A-register contains input byte; 


input 




JR 


Z,WAIT ;Z=1 IF KB CLEAR 


byte is displayed at current cursor 








DISPLAY BYTE 




PUSH 


DE 


;MUST SAVE 


AT CURSOR 




PUSH 


IY 


; DE&IY 






LD 


A,20H 


;BYTE TO DISPLAY 






RST 


10H 


;DISPLAY BYTE 






POP 


IY 


;RESTORE 






POP 


DE 


; DE&IY 


TURN ON 




CALL 


0FE9H 




CASSETTE 










On board cassette is turnec 


on via 








remote plug 










SAVE MEMORY 




CALL 


0FE9H 


•TURN ON CASSETTE 


TO CASSETTE 




LD 


HL.7000H 


;START ADDRESS 


Cassette is turned off 




LD 


DE,7100H 


;LAST+1 ADDRESS 






CALL 


0F4BH 


;SAVE IT 



LOAD MEMORY 

FROM CASSETTE 

On return HL = last + 1 address 

Z = if checksum error 
Z = 1 if checksum OK 
Cassette is turned off 

RETURN TO 

LEVEL I BASIC 



RETURN TO TBUG 



CALL 



0EF4H 



;TURN ON & READ 



Press 

JP 
JP 



RESET 


01C9H 



;POWER UP 

;RE-ENTRY WITH READY 



Set a Breakpoint to next opcode address. 

JP 40B1H ;RE-ENTER TBUG 
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LEVEL II BASIC Addresses 



TURN ON CURSOR 
CHARACTER 



KEYBOARD SCAN 

A register contains byte when loop 

falls through. 

Byte is not displayed on screen! 



DISPLAY BYTE 
AT CURSOR 



DEFINE DRIVE 



WRITE LEADER 

AND SYNC BYTE 

TURN OFF 
CASSETTE 

SAVE MEMORY 
TO CASSETTE 
USER must CALL 264H often 
enough to keep up with 500 baud. 
Timing is automatic. 



LOOK FOR LEADER 
AND SYNC BYTE 



PUSH 


DE 


;MUST SAVE 




PUSH 


IY 


; DE&IY 




LD 


A,0EH 


;0EH IS CURSOR BYTE 


CALL 


33H 


;DISPLAY ROUTINE 


POP 


IY 


;RESTORE 




POP 


DE 


; DE&IY 




AGN 


PUSH 


DE 


MUST SAVE 




PUSH 


IY 


DE&IY 




CALL 


2BH 


SCAN ROUTINE 




OR 


A 


A=0 IF KB CLEAR 




JR 


Z,AGN 


BRANCH IF NO BYTE 




POP 


IY 


RESTORE 




POP 


DE 


DE&IY 




PUSH 


DE 


MUST SAVE 




PUSH 


IY 


DE&IY 




LD 


A,20H 


BYTE TO DISPLAY 




CALL 


33H 


DISPLAY 




POP 


IY 


RESTORE 




POP 


DE 


DE&IY 


;A-REGISTER SPECIFIES 


CASSETTE (0 OR 1) 




LD 


A,0 


ON BOARD 


CASSETTE 










CALL 


0212H 


DEFINE DRIVE 




CALL 


0287H 





CASSETTE 



CALL 



01F8H 



LD 


A,0 


;ON BOARD 


CALL 


0212H 


;DEFINE DRIVE 


CALL 


0287H 


;WRITE LEADER 


LD 


A,20H 


;BYTE TO RECORD 


CALL 


0264H 


;OUTPUT BYTE 


CALL 


01F8H 


;CASSETTE OFF 


CALL 


0296H 
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LOAD MEMORY 

FROM CASSETTE 
User must CALL 023 5H often 
enough to keep up with 500 baud. 
User must do own checksum if 
desired. A-register contains byte 
read. The user must turn off the 
Cassette (CALL 01F8H) when all 
bytes have been read. 

RETURN TO 

LEVEL 11 BASIC 



RETURN TO TBUG 

(UNDER LEVEL II BASIC) 

OUTPUT TO LINE PRINTER 
(LEVEL II ONLY) 



LD 


A,0 




CALL 


0212H 


;DEFINE DRIVE 


CALL 


0296H 


;FIND SYNC BYTE 


CALL 


0235H 


;READ ONE BYTE 



Press 

JP 
JP 



RESET 


1A19H 



Set a Breakpoint to next opcode address. 
JP 43A0H 



;LIKE POWER UP 
;RE-ENTRY 



;RE-ENTER TBUG 



;PUT ASCII BYTE IN 
;A-REGISTER AND CALL PRTOUT 
;BUSY CONDITION TESTED FOR 



PRTOUT 


EXX 






LD 


HL,37E8H 


PRTLP8 


LD 


D,(HL) 




BIT 


7,D 




JP 


NZ,PRTLP8 




LD 


(HL),A 




EXX 






RET 





SAVE REGS. 

LOAD LP POINTER IN HL 
LOAD LP STATUS BYTE 
IS THE PRINTER BUSY? 

;OUTPUT BYTE TO PRINTER 
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Appendix F Base Conversions 



BINARY 


HEX. 


DECIJ 


00000000 


00 





00000001 


01 


1 


00000010 


02 


2 


00000011 


03 


3 


00000100 


04 


4 


00000101 


05 


5 


00000110 


06 


6 


00000111 


07 


7 


00001000 


08 


8 


00001001 


09 


9 


00001010 


0A 


10 


00001011 


OB 


11 


00001100 


oc 


12 


00001101 


OD 


13 


00001110 


OE 


14 


00001111 


OF 


15 


00010000 


10 


16 


00011000 


18 


24 


00100000 


20 


32 


00101000 


28 


40 


00110000 


30 


48 


00111000 


38 


56 


01000000 


40 
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BINARY HEX. DECIMAL 



01001000 


48 


72 


01010000 


50 


80 


01011000 


58 


88 


01100000 


60 


96 


01101000 


68 


104 


01110000 


70 


112 


01111000 


78 


120 


10000000 


80 


128 


10001000 


88 


136 


10011000 


90 


144 


10011000 


98 


152 


10100000 


AO 


160 


10101000 


A8 


168 


10110000 


BO 


176 


10111000 


B8 


184 


11000000 


CO 


192 


11001000 


C8 


200 


11010000 


DO 


208 


11011000 


D8 


216 


11100000 


EO 


224 


11101000 


E8 


232 


11110000 


FO 


240 


11111000 


F8 


248 


11111100 


FC 


252 


11111110 


FE 


254 


11111111 


FF 


255 



39 



Appendix G. Where to Look for More Information 

The Z-80 Microcomputer Handbook, by William Barden, Jr. Howard W. Sams & Co., Inc. 

Z-80 Assembly Language Programming, A Zilog, Inc., Publication 

Z-80 Programming for Logic Design, by Adam Osborne et al. Osborne 
& Associates, Inc. Berkeley CA 
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IMPORTANT NOTICE 

ALL RADIO SHACK COMPUTER PROGRAMS ARE DISTRIBUTED ON AN "AS |#1 
IS" BASIS WITHOUT WARRANTY 

Radio Shack shall have no liability or responsibility to customer or any other person or 
entity with respect to any liability, loss or damage caused or alleged to be caused directly 
or indirectly by computer equipment or programs sold by Radio Shack, including but not 
limited to any interruption of service, loss of business or anticipatory profits or 
consequential damages resulting from the use or operation of such computer or computer 
programs. 

NOTE: Good data processing procedure dictates that the user test the program, run and 
test sample sets of data, and run the system in parallel with the system 
previously in use for a period of time adequate to insure that results of 
operation of the computer or program are satisfactory. 
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280-316 VICTORIA ROAD 
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BILSTON ROAD WEDNESBURY 
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